<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
<html>
<head>
  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
  <meta http-equiv="Content-Style-Type" content="text/css">
  <title></title>
  <meta name="Generator" content="Cocoa HTML Writer">
  <meta name="CocoaVersion" content="949.54">
  <style type="text/css">
    p.p1 {margin: 0.0px 0.0px 0.0px 0.0px; font: 25.0px Helvetica}
    p.p2 {margin: 0.0px 0.0px 0.0px 0.0px; font: 12.0px Helvetica; min-height: 14.0px}
    p.p3 {margin: 0.0px 0.0px 0.0px 0.0px; font: 12.0px Helvetica}
    p.p4 {margin: 0.0px 0.0px 0.0px 0.0px; font: 18.0px Helvetica}
    p.p5 {margin: 0.0px 0.0px 0.0px 0.0px; font: 14.0px Helvetica}
    span.s1 {text-decoration: underline}
  </style>
</head>
<body>
<p class="p1"><b>Input Panel</b></p>
<p class="p2"><br></p>
<p class="p3">The <b>Input Panel</b> is in the top left area of Cecilia's interface:</p>
<p class="p2"><br></p>
<center><img src="./images/input.png" alt="Cecilia's Input Panel"></center>
<p class="p2"><br></p>
<p class="p3">It allows the user to load one or many soundfiles for processing. The <b>Input Panel</b> can contain more that one input source. For example, in a convolution module, two sounfiles are needed:</p>
<p class="p2"><br></p>
<center><img src="./images/inputMultipleSources.png" alt="Cecilia's Input - Multiple Sources"></center>
<p class="p2"><br></p>
<p class="p3">Each input source is identified by a tag preceding the filename region (in this case, <i>Audio</i>):</p>
<p class="p2"><br></p>
<center><img src="./images/inputFilename.png" alt="Cecilia's Input Filename"></center>
<p class="p2"><br></p>
<p class="p3">and a serie of tools:</p>
<p class="p2"><br></p>
<center><img src="./images/inputTools.png" alt="Cecilia's Input Tools"></center>
<p class="p2"><br></p>
<p class="p4"><span class="s1"><b>Loading a soundfile</b></span></p>
<p class="p2"><br></p>
<p class="p3">To load a soundfile, click on the <i>Folder</i> icon in the tools. A file dialog asking to choose a soundfile will popup. After selecting it and clicking open, the filename will be added to the <b>Input Panel</b>:</p>
<p class="p2"><br></p>
<center><img src="./images/inputSound.png" alt="Cecilia's Input - Loaded Sound"></center>
<p class="p2"><br></p>
<p class="p3">When a sound is loaded, Cecilia automatically scans the whole folder where the file resides. Cecilia identifies all soundfiles in that directory and adds them to a contextual menu. This popup menu gives the user a quick access to all the soundfiles of a directory. The user only has to click on one of the soundfiles in the menu in order to rapidly load it as a source.</p>
<p class="p2"><br></p>
<center><img src="./images/inputSoundMenu.png" alt="Cecilia's Input - Contextual Menu for Loading Sound"></center>
<p class="p2"><br></p>
<p class="p4"><span class="s1"><b>Tools</b></span></p>
<p class="p2"><br></p>
<p class="p3">Next to the filename of the loaded soundfile, there is a group of 4 tools:</p>
<p class="p2"><br></p>
<center><img src="./images/inputTools.png" alt="Cecilia's Input Tools"></center>
<p class="p2"><br></p>
<p class="p3">1) Clicking on the <i>speaker</i> icon will open the soundfile in the player application. It allows the user to hear the soundfile without any processing. The player application must be set in the <i>Preference Panel</i>.</p>
<p class="p2"><br></p>
<p class="p3">2) The <i>scissors</i> icon opens the soundfile in an edition application. The soundfile can then be edited before being processed in Cecilia. The edition application must be set in the <i>Preference Panel</i>.</p>
<p class="p2"><br></p>
<p class="p3">3) The <i>folder</i> icon allows the user to load a soundfile through a file dialog.</p>
<p class="p2"><br></p>
<p class="p3">4) The <i>arrow</i> icon opens a window that lets the user set parameters of the sound. This window is dependant on the type of input defined by the module creator. It can either be a <b>sampler</b> window or a <b>file input</b> window.</p>
<p class="p2"><br></p><br>
<p class="p5"><span class="s1"><b>Sampler</b></span></p><br>
<p class="p3">The <b>sampler</b> gives a great deal of control over the input soundfile. It is intended to mainly control the playback of the soundfile. It gives access to looping, gain control and transposition of the sound prior to entering Cecilia processes.</p>
<p class="p2"><br></p>
<p class="p3">The <b>sampler</b> offers the possibility to load a soundfile whose number of channels<span class="Apple-converted-space">  </span>is different then the Cecilia module output. For example, the user could load a quadraphonic soundfile and, with the automatic assistance of the <b>sampler</b>, use it in a stereo module. The <b>sampler</b> uses a distribution algorithm to convert a non-matching format (say, quadraphonic) to the desired output format (stereo).</p>
<p class="p2"><br></p>
<p class="p3">The <b>sampler</b> parameters can be recorded and played back with the automation system. This means that all parameters are attached to a graph line that can be edited.</p>
<p class="p2"><br></p>
<p class="p3">If the input module used is a <b>sampler</b> (in most cases), the window opening by clicking the arrow tool will look like this:</p>
<p class="p2"><br></p>
<center><img src="./images/inputSamplerWindow.png" alt="Cecilia's Sampler Window"></center>
<p class="p2"><br></p>
<p class="p3">In this window, a header describes the caracteristics of the soundfile loaded. It gives its absolute path, duration, file type, bit depth, number of channels and sample rate.<span class="Apple-converted-space"> </span></p>
<p class="p2"><br></p>
<p class="p3">A first slider (named <i>Offset</i>) allows the user to modify the starting point of reading in the soundfile.</p>
<p class="p2"><br></p>
<p class="p3">The <b>sampler</b> normally plays the input soundfile in loop. The <b>looping mode</b> can be set using the context menu. Available looping modes are:<span class="Apple-converted-space"> </span></p>
<p class="p3">- <b>Off</b>: The sound is played once and then stops.</p>
<p class="p3">- <b>Forward</b>: The sound is played repeatedly from the beginning to the end.</p>
<p class="p3">- <b>Backward</b>: The sound is played repeatedly from the end to the beginning.</p>
<p class="p3">- <b>Back &amp; Forth</b>: The sound is played forward and then backward alternativelty.</p>
<p class="p2"><br></p>
<p class="p3">The <b>Start from loop</b> toggle allows the user to set the starting point of reading in accordance with the <b>Loop in</b> slider.</p>
<p class="p2"><br></p>
<p class="p3">A set of three tools in the <b>sampler</b> window is similar to the <b>input tools</b> described earlier. The <i>speaker</i> and <i>scissors</i> icons have the same functionality. The <i>clock</i> icon links the performance duration to the duration of the soundfile. Clicking on it will automatically reajust the duration slider in the <i>Output Panel</i>.</p>
<p class="p2"><br></p>
<p class="p3">Three sliders define the loop parameters of an input source. The <b>Loop In</b> slider sets the time in the soundfile where a loop starts. The <b>Loop Time</b> slider sets the duration of a loop. The <b>Loop X</b> slider is linked to the crossfade time between two loops.</p>
<p class="p2"><br></p>
<p class="p3">The <b>Gain</b> slider controls the input level of a sound.</p>
<p class="p2"><br></p>
<p class="p3">The <b>Transpo</b> slider controls the direct transposition of the input soundfile.<span class="Apple-converted-space"> </span></p>
<p class="p2"><br></p><br>
<p class="p5"><span class="s1"><b>File input</b></span></p><br>
<p class="p3">If the input module used is a <b>file input</b> (for instance, in cases where the soundfile is to be input into a table with a GEN 1 function), the window opening by clicking the arrow tool will look like this:</p>
<p class="p2"><br></p>
<center><img src="./images/inputFileInWindow.png" alt="Cecilia's File Input Window"></center>
<p class="p2"><br></p>
<p class="p3">In this window, a header describes the caracteristics of the soundfile loaded. It gives its absolute path, duration, file type, bit depth, number of channels and sample rate. A single slider offers the user to modify the starting point of reading in the soundfile.</p>
<p class="p2"><br></p>
<p class="p3">A set of three tools in the <b>file input</b> window are similar to the <b>input tools</b> described earlier. The <i>speaker</i> and <i>scissors</i> icons have the same functionality. The <i>clock</i> icon links the performance duration to the duration of the soundfile. Clicking on it will automatically reajust the duration slider in the <i>Output Panel</i>.</p>
<p class="p2"><br></p>
<p class="p3"><br></p>
<p class="p3"><br></p>
<center><p class="p3">Return to <a href="./usingCecilia.html">Using Cecilia</a> section</p></center>
</body>
</html>
